home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-21 / tpmul220.zip / MULAWARE.DOC < prev    next >
Text File  |  1992-02-25  |  7KB  |  296 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                      MulAware (MultiTasker Aware) v2.20
  16.  
  17.             Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  18.  
  19.                      Designed & Written by Jack Ridgway
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                   Page 1
  58.  
  59.     MulAware v2.20 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.    DISCLAIMER
  67.  
  68.      Users of MulAware must accept this disclaimer of warranty:
  69.      "MulAware is supplied as is.  The author disclaims all warranties,
  70.      expressed or implied, including, without limitation, the warranties
  71.      of merchantability and of fitness for any purpose.  The author
  72.      assumes no liability for damages, direct or consequential, which
  73.      may result from the use of MulAware."
  74.  
  75.  
  76.    FREEWARE AGREEMENT
  77.  
  78.      MulAware is a "freeware program" and is provided at no charge to
  79.      the user.  Feel free to share it with your friends, but please do
  80.      not give it away altered or as part of another system.  Anyone
  81.      distributing MulAware for any kind of remuneration must first
  82.      contact A.B.S. at the address listed below for authorization.
  83.      This authorization will be automatically granted to distributors
  84.      recognized by the (ASP) as adhering to its guidelines for
  85.      shareware distributors, and such distributors may begin offering
  86.      MulAware immediately; however, A.B.S. must still be advised so that
  87.      the distributor can be kept up-to-date with the latest version of
  88.      MulAware.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                   Page 2
  117.  
  118.     MulAware v2.20 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.    WHAT IS MulAware?
  126.  
  127.      MulAware is a Turbo Pascal 6.0 Unit to make your programs fully
  128.      MultiTasker Aware.  MulAware currently supports the following
  129.      multitaskers:
  130.  
  131.      Windows 386 2.xx
  132.      Windows 3.0 in 386enh mode
  133.      DESQview 2.26+
  134.      DoubleDOS
  135.      TaskView, TopView, OmniView, & clones
  136.  
  137.      VMiX, and possibly others, will be added in the future.
  138.  
  139.      MulAware is 95% Assembler Code, and is very efficient and fast.
  140.      
  141.  
  142.    HOW TO USE MulAware
  143.  
  144.      Since this is a programmer's tool, I'm going to assume you have
  145.      decent knowledge of computers in general, and Turbo Pascal in
  146.      particular.  Simply place MulAware in your USES statement.
  147.  
  148.      USES
  149.        Crt,
  150.        MulAware,
  151.        Dos;
  152.  
  153.  
  154.    PROCEDURES & FUNCTIONS
  155.  
  156.      See the enclosed MULAWARE.INT for correct calling procedures.
  157.  
  158.      MulAware defines 5 typed boolean constants, and contains 4 procedures
  159.      and 3 functions.
  160.  
  161.      The constants are:
  162.      MultiTasker - True if any multitasker is present
  163.      DV_Loaded   - True if DESQview loaded
  164.      TV_Loaded   - True if TopView or Compatible loaded
  165.      DDOS_Loaded - True if DoubleDOS loaded
  166.      WIN_Loaded  - True if Windows 3.0 386enh or Windows 386 2.xx loaded
  167.  
  168.      They are all initialized to False, and checked in the order listed;
  169.      therefore, although DESQview is TopView compatible, if DV is present,
  170.      TV_Loaded will be false.  MultiTasker is initialized to true, and
  171.      is set to false if MulAware is unable to detect one of the supported
  172.      multitaskers.
  173.  
  174.  
  175.                                   Page 3
  176.  
  177.     MulAware v2.20 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.      The procedures are:
  185.  
  186.      TimeSlice
  187.        Causes the current task to give up the rest of its time slice.
  188.        Useful in loops while waiting for keyboard input.
  189.        This procedure is valid for all.
  190.  
  191.      PreventSwitching
  192.        Suspends multitasking and only services the current task.
  193.        Useful during critical program functions.
  194.        This procedure is valid for all.
  195.  
  196.      ResumeSwitching
  197.        Called to resume multitasking after it has been suspended by
  198.        PreventSwitching.
  199.        This procedure is valid for all.
  200.  
  201.      TV_UpdateBuffer(Num : Word; Buffer, CharOffset : Word)
  202.        Must be called when running under TaskView or clones to update
  203.        the screen from the virtual buffer.  This may be called under
  204.        DESQview, but doing so will cause DESQview to stop updating the
  205.        screen automatically.  Num contains the number of sequential
  206.        characters that were changed.  Buffer:CharOffset points to the
  207.        first character changed.
  208.  
  209.      The functions are:
  210.  
  211.      VirtualBuffer : Word
  212.        Returns the address of the virtual video buffer.
  213.        Useful for doing direct screen writes without 'bleed through'.
  214.        This function is valid for DESQview and TopView.
  215.        For DoubleDOS, this procedure must be called everytime you wish
  216.        to do a direct write, because the buffer changes.
  217.        Under Windows, this returns 0.
  218.  
  219.      DDOS_Visible : Boolean
  220.        Returns true if the current task is the visible task under DoubleDOS.
  221.        Returns false if DDOS NOT running OR if the current task is the
  222.        invisible task.  You must check DDOS_Loaded if a false is returned.
  223.  
  224.      MulVersion : Word
  225.        Returns the version number for DESQview, TopView, Windows (200 for
  226.        2.xx), 0 for TaskView, unknown for OmniView.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                   Page 4
  235.  
  236.     MulAware v2.20 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.    REGISTRATION
  244.  
  245.      MulAware is distributed as FreeWare.  This is a contribution to all
  246.      the shareware/freeware/pd programmers, to whom I certainly owe a
  247.      lot.  Please read the DISCLAIMER & FREEWARE AGREEMENT earlier in
  248.      the documentation for more information.
  249.  
  250.      Fully commented source code for MulAware is available for $50.
  251.      This includes a royalty free license agreement and one year of
  252.      free upgrades.
  253.  
  254.      ABSMulti is a commercial product also available from A.B.S.
  255.      ABSMulti is a SUPERSET of the routines contained in MulAware. It
  256.      contains most of the DESQview, TopView, and DoubleDOS APIs, as
  257.      well as all Windows functions accessible from a DOS program.
  258.      ABSMulti is $100, and it comes with fully commented source code,
  259.      a royalty free license agreement, documentation, and one year of
  260.      free upgrades.
  261.  
  262.  
  263.    TECHNICAL SUPPORT
  264.  
  265.      A.B.S.
  266.      P.O. Box 55647
  267.      Jackson, MS 39296-5647
  268.      601-362-4071  9am-6pm CST
  269.  
  270.      The Big Bang Theory BBS
  271.      SysOp: Jack Ridgway
  272.      601-366-1664
  273.      USR Dual Standard
  274.  
  275.      CIS - 70740,450
  276.      GEnie - J.RIDGWAY4
  277.      SL_Net - 250:302/532
  278.      FidoNet - 1:3632/104
  279.  
  280.  
  281.    ACKNOWLEDGMENTS
  282.  
  283.      * Turbo Pascal is a registered trademark of Borland International
  284.      * MS-DOS is a registered trademark of Microsoft Corporation
  285.      * DESQview is a registered trademark of Quarterdeck Office Systems
  286.      * VMiX is a registered trademark of Commercial Software Associates
  287.      * Windows is a registered trademark of Microsoft Corporation
  288.      * All other programs are (c) and/or (tm) by their respective
  289.        author unless otherwise noted
  290.  
  291.  
  292.  
  293.                                   Page 5
  294.  
  295.     MulAware v2.20 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  296.